home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / fchown.txt < prev    next >
Text File  |  1992-03-24  |  1KB  |  64 lines
  1. Fchown(2)                 Dec. 12, 1991                 Fchown(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Fchown - change a file's ownership
  7.  
  8. SYNOPSIS
  9.      LONG Fchown( char *name, WORD uid, WORD gid );
  10.  
  11. DESCRIPTION
  12.      Fchown changes a file's user and group ownership to uid  and
  13.      gid  respectively.  These ownerships determine access rights
  14.      to the file.
  15.  
  16.      Only a process with effective uid 0 or whose  effective  uid
  17.      matches  the  user ownership of the file may make this call.
  18.      In the latter case, the new uid must match the old one,  and
  19.      the  calling  process  must  also  be  a member of the group
  20.      specified by gid.
  21.  
  22. RETURNS
  23.      0 on success
  24.  
  25.      EACCDN if the calling process has  an  effective  uid  which
  26.      differs from the owner of the file and which is not 0.
  27.  
  28.      EINVFN if the file system on which the file is located  does
  29.      not support a notion of ownership. (This is true of the nor-
  30.      mal TOS file system.)
  31.  
  32.      EFILNF if the file is not found
  33.  
  34.      EPTHNF if the path to the file is not found.
  35.  
  36. SEE ALSO
  37.      Fchmod(2), Fxattr(2)
  38.  
  39. BUGS
  40.      Most file systems don't understand file ownership.
  41.  
  42.      In practice, the call  is  useful  only  to  processes  with
  43.      effective uid 0.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.92  Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.